{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "- 总体架构\n",
    "\n",
    "```\n",
    "+-----------------------+\n",
    "|  Config (YAML / JSON) |\n",
    "+-----------+-----------+\n",
    "            |\n",
    "            v\n",
    "+-----------+-----------+\n",
    "|   GDB Python Layer    | ① 读取配置，注册断点/事件\n",
    "| - Watch Manager       | ② 收集变量/栈信息\n",
    "| - Serializer          | ③ 输出结构化事件\n",
    "+-----------+-----------+\n",
    "            |\n",
    "            v\n",
    "+-----------+-----------+\n",
    "|  Data Sink / Transport | ④ 文件 / 管道 / WebSocket\n",
    "+-----------+-----------+\n",
    "            |\n",
    "            v\n",
    "+-----------+-----------+\n",
    "|   Visualization Layer | ⑤ 离线脚本 / Web UI / Jupyter\n",
    "+-----------------------+\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "- GDB Python 层的设计\n",
    "\n",
    "```\n",
    "algviz/\n",
    "├── config/\n",
    "│   └── sample.yml          # 配置样例\n",
    "├── scripts/\n",
    "│   ├── gdb_driver.py       # 启动 GDB 的 Python 程序\n",
    "│   ├── gdb_layer.py        # 在 GDB 中运行的 Python 模块\n",
    "│   ├── serializers.py      # 数据序列化适配器\n",
    "│   └── adapters/\n",
    "│       ├── base.py\n",
    "│       ├── stl_vector.py\n",
    "│       └── primitive.py\n",
    "├── cli.py                  # 算法可视化 CLI 入口\n",
    "├── visualize/\n",
    "│   ├── offline.py          # 离线绘图工具\n",
    "│   └── web/                # Web 可视化前端（后续再建）\n",
    "└── demos/\n",
    "    └── demo.cpp            # 示例算法代码\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "- 初始化仓库与虚拟环境\n",
    "\n",
    "```shell\n",
    "$ python3 -m venv .venv\n",
    "$ source .venv/bin/activate\n",
    "$ pip install --upgrade pip\n",
    "```"
   ]
  }
 ],
 "metadata": {
  "language_info": {
   "name": "python"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}
